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ABSTRACT 


This paper describes the design of an interactive system to aid in 
the analysis of problems which involve directed graphs. The digital 
computing system is assumed to have a graphic display device on which 
directed graphs may be drawn and from which light pen, function key- 
board, and alphanumeric keyboard information may be transmitted on-line 
to the system. Directed graphs are represented in core storage by a 
dynamically allocated hierarchical list structure. User-written analysis 
routines are linked to the system to apply it to a particular field of 
problems. An initial implementation of its capabilities on the IBM 360/67 
with an IBM 2250 Display Unit was written in PL/I (F). Under the IBM 
System/360 Operating System, it executed in less than 200K bytes and 


provided reasonable response to on-line interaction. 
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I. INTRODUCTION 


This paper describes a system designed to aid in the on-line 
analysis of problems which involve directed graphs. Likely appli- 
cations include PERT network analysis, electronic circuit analysis and 
artificial intelligence. A PL/I (F) program was implemented on the IBM 
System/360 Model 67 using the IBM 2250 Display Unit and approximately 
200K bytes of core storage. The program demonstrates some of the 
capabilities of the system described and is appended with a users’ 
manual to this paper. 

Chapter II gives definitions and explains concepts used in the 
paper and the program. Directed graphs, progressions, reachable sets, 
and cells and pointers used in list processing are presented. 

The design of the program is described in Chapter III. Discussed 
therein are some of the goals of an interactive system. This chapter 
also contains a detailed ee Ton of a hierarchical list structure 
representing a directed graph and a sample algorithm which traverses 
the structure. 

Chapter IV concludes the paper with some comments on the system and 
implementation. A program listing appears as the last section of the 
paper. Output from a sample run is also included with some pictures of 
the 2250 Display Unit during a run. Finally, Appendix A contains a 


users’ manual for the program. 





II. FUNDAMENTAL CONCEPTS 


In this chapter, basic concepts of directed graphs essential to 
understanding this paper are developed. Many of the definitions are 
from a text written by Busacker and Saaty [1]. Their textbook Finite 
Graphs and Networks contains concise definitions used in graph theory. 
Their book also discusses many graph theory applications. 

Some definitions in graph theory have not found universal accept- 
ance. In order to avoid unnecessary confusion, this paper will use 
the terminology consistent with Busacker and Saaty [1]. 

A directed graph is usually an abstract model of a real situation. 
To arrive at an unambiguous definition of an abstract graph, Euclidean 
3-dimensional space is employed to define a geometric graph, then from 
that the definition of an abstract graph is obtained. Euclidean | 


3-space consists of triplets of real numbers. 


A, GEOMETRIC GRAPHS 

A simple open curve in Euclidean 3-space is a continuous, non- 
self-intersecting curve joining two distinct points. A simple closed 
curve is the same as a simple open curve except that its endpoints 
eeimcide. Now, a geometric graph in Euclidean 3-space is a set 
V ={v. of points in Euclidean 3-space and a set A = {a.f of simple 
curves (open and closed) satisfying the following conditions: 

bm unewetosea clirves im A Contain only one point in V. 


2) The open curves in A have as endpoints two points in V. 


3) No two curves in A have common points except for points in V. 





Thus, a geometric graph is simply a system of points connected by 
Somves. | ihe Curves intersect one another only at points in V. The 
most common real life example might be a network of highways--inter- 
sections representing points and the highways between intersections 


representing curves. 


B. ABSTRACT GRAPHS 

The notion of a geometric graph is indeed concise, but carries with 
it more information than is normally needed in the applications of 
graph theory. The exact spacial location of the points of a graph in 
Euclidean space is not essential in most directed graph analysis. The 
most important property of a geometric Seen is the connectivity of 
the graph: which two vertices in V are connected by a curve in A. 

The connectivity of a graph now can be described with the following 
MObAE1 OM : 

Co Ue V1) 
which reads, “curve a. starts at vertex va and ends at vertex Si In 
this manner each curve in A is mapped into an ordered pair of vertices 
in V. Each of the possible ordered pairs of the elements in V are 
elements of the cartesian cross product VX V. If V = LY 43%) : then 
the set V X V = {iw ,.v,) (Vj 2Vo)> (v5.V1)> Creve): 

An abstract graph or simply a graph is composed of a set (of 
vertices) V, a set (of arcs) A, and a mapping of A into V X V. The 
definition must also include the restriction that no element of A is 
in V. This last statement stresses the point that in «n abstract graph 


a point cannot also be a curve. 





The system G, = (VA, 24) is a subgraph of a graph G = (V,A,4) 
if the following conditions are satisfied: 


1) Vy is a subset of V and Ay is a subset of A. 


2) For every a in Ay> A, (a) = A(a). 


3) For every a in A 


elements of Vi- 


° oy 
1? ae A, (a) Cer then e and us are 


The system G, = (Vj »A,54)) is an induced subgraph of G = (V,A,4) 
if the following conditions are satisfied: 
1) G, is a subgraph of G. 


2) Every arc a, A(a) —> (u,v), in A is in Ay if u and v are 
elements of V.. 


1 

Although an abstract graph is not defined in a 3-dimensional space, 
it is often useful if not invaluable to picture this abstract model by 
drawing it on a piece of paper or displaying it on a cathode ray tube. 
Through man's hevristic properties, drawings and pictures seem to mean 
more than just describing a graph as two sets and a mapping function. 
Solving some graph theory problems depends to some degree on a drawing 
of a graph. Any drawing of a graph, for which the only common points 
of arcs are the vertices, is called a geometric realization of the graph. 
Many geometric realizations of a given graph exist. If a graph is 
defined as G = (V,A,A), V= Eee \ A = eae eat: and 
A(a,) ae (V,0Vo), A(a,) —> (Vo 5Vq); and (ag) ee (V)»V3)3 then 
one comprehends more about the graph by looking at some of its geo- 
metric realizations shown in Figure 1. Each one, because it looks 
different from the others, imparts different unquantifiable infor- 


mation. This is one of the reasons for the use of the IBM 2250 Display 


Unit in the design and operation of the system. 








Figure !. Three geometric realizations of a graph 


GC. PROGRESSIONS 


Aa ane progression 1s an ordered sequence of arcs ay» As > Agy--+> 
satisfying one condition: 
An ordered sequence of nodes v,, v,, ...; V must exist 
1 2 ne 
such that 
A(a,)-> (V5 2Vi44)> EOD So ey. TES 
A path progression is an arc progression for which vy é ee and 


no arc appears in the sequence more than once. 
A cycle pr i is an arc progression for which v, =v and 
ycle progression is an prog 1 Ea 
no arc appears in the sequence more than once. 
The length of a progression is simply the number of arcs in the 


sequence. A progression is said to lead from v, fo v Que slats 


n+]? 


progression starts at v An arc a which maps into 


aril 


and ends at v 
i ——— n 


(v,w) is positively incident with the initial node v and negatively 
incident with the terminal node w. 

Consider the graph G in Figure 2. Some progressions, their type, 
length, and starting and ending nodes are shown in Table I. Some 
sequences of arcs which are not progressions are shown in Table IT. 


2 


a 








Figure 2. A directed graph 


some progressions Type Length From To 


ay path 1 Vo vy 
Az), path 2 V1 Vy, 
278485 Pa 
Re 37 eC al 4 2 2 
ee a a> ce 4. v2 v2 
A513 aaa ‘3 nec} 
Table I. Progressions in graph G in Figure 2. 
ee el Oe 3 
4°73 Bata? sea 3 2) 


Table II. Some sequences in graph G which are 
not progressions. 

D. REACHABLE SETS 

During the analysis of a graph, some algorithms "look at" a node, 
say V.; and ask, "Which nodes are at the end of arcs starting at v2 
Using the definition of a progression, the question may be restated: 
Which nodes are at the end of all length 1 progressions starting at 
v.? This set of nodes is called the reachable set of the node v. and 
is denoted R(v,). The superscript of the reachable set is the length of 
progressions considered. R' (v,) is the set of nodes which are at the end 


of all length n progressions starting at V5. 
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R'(v,) is the set of starting nodes of all length n progressions 
ending at Vi. RU (Vy 2Vg9+ + 9¥,) is the union of the sets R(v,); 
R' (v5), eee RY (v,). To cover all possible integer values of n, 
R°(v,) = {v,§. 

An arc is said to be a loop is it starts and ends at the same 
node. Therefore, if a. is a loop starting and ending at Ve then 
Vv. is in R(v,). Further, since an arc may be repeated in an arc 
progression, V5 would also be in R'(v,) for all values of n. 

Consider the graph G in Figure 3. Some reachable sets are 


presented in Table III. Note that if R'(v.) of any node v. contains 


Vo» then RM) also contains Vo form= 1,2, 3, ... due to the 


loop ae. 





Figure 3. A directed graph with a loop 


n Vv R' (v) arc progressions 
: 2 ee Si ; and a.,a 
3 ee sao 2 ene a eA a oa é 
6 is Vv a A eas aed ee ne aear nde sa a 
5 Dita to ae 5 Meese. 10 30 6. We oO 0° 1 
GS Sa 2? 4? 5 22 “i? 5? 6? 6°? Das tee 
and ay saa a. 5a, a 
-2 Vy, VorVy apea, an eka st 
-3 Vv Vv 
2 Rey ey, . Voy re “7 , bo ee anja 
1 2a Go Gro a 1 2 2g 


Table III. Some Reachable Sets of graph G in Figure 3. 
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The definition of a path reachable set is similar to that of the 
Beaenabie set. The path reachable set of node Vi» Ba) is the set 
of all nodes at the end of all length n path progressions starting at 
V.. P'(v.) is defined as the set of starting nodes of all length n 


progressions ending at Va. Again, to cover all possible integer 


values of n, P’(v,) is defined as the empty set op. P'(v,5v 


Ven Oe) 
. i yer k 
= )UP wo ; 

; i 
i=l] 


n 
A cumulative reachable set Rau) = 49 U kof. Likewise, the 
ie CC ia j 
n = i 
cumulative path reachable ‘set Ro) =fu rot Table IV shows some 
i=l 


path reachable sets of graph G in Figure 3. 


it 


n Vv P (v) path progressions 

1 V ee a, and a 

2 or ve aC aed] .a--and d_.a 

3 et oe s ea oo Pand aera >a 6 
4 yi ye. 5 Eo te , B2 5°42 57 
-2 a ae Vv Bae aoa : a 
-3 ae vi y2 ee a Be ast aga 

2 IG ) oor V ee b alan mie a 

[ bo ee 6° Glee 1? se ae 


Table IV. Some path reachable sets of graph G in Figure 3. 


E. SUPER-NODES AND SUPER-ARCS 

In many applications of graph theory, the number of nodes and arcs 
is quite large. Consider the geometric realization of a graph of every 
street, alley, thoroughfare and intersection of a large city like 
Chicago. If one could find a sheet of paper large enough on which to 
draw it, the probability of drawing it without error would be quite 
small. Assuming that it has been drawn successfully, using it to 
answer various questions about Chicago would be difficult if not 


impossible! For instarce, if the question, "How many thoroughfares 


2 





intersect Interstate 80,'' were asked, one would have to sift through 
the maze of alleys and residential streets to first locate Interstate 
80 at some point on the drawing. Then one would have to follow it 
asking at each intersection if the streets connected to Interstate 80 
were thoroughfares. It would be much easier to attack the overall 
problem in a manner similar to the approach used by the county cart- 
ographers. Draw a map showing just Interstate highways and inter- 
sections with major thorouchfares. Also put on the map references to 
sectional maps showing in a little more detail the area concerned. 

The sectional map might also contain references to detail maps showing 
all streets and alleys of a sub-subsection of the city. Answering the 
questions above would be much easier. One would not be forced to 
bother with the small streets and alleys. If a question were asked 
which called for information about the small streets and alleys of the 
city, one could reference the detail maps as desired. 

This is perhaps an overworked example justifying the concept of a 
super-node. The idea is simple: Represent an induced subgraph with a 
single super-node, maintaining connections to and from the subgraph in 
the following manner. 

Let G, = (V, 2A, 24)) be an induced subgraph of G = (V,A,A). Let 


super~-node v,, be an element of V representing the subgraph G 


11 1° 
Dente) so (u,v) such that u ¢ V-V 


negatively incident with Yon 


ite (ayes (v,u) such that v ¢ V 
positively incident with Var 


and ve V then a is 


1 i 


and u ¢ V-V then a is 


1 ie 


An arc which is incident with a super-node is called a super-arc. 
To completely specify a graph containing super-nodes and super-arcs, 


additional notation is used to define a graph G = (V,A,V). To completely 
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specify a super-node in V, the graph that it represents must be 
associated with the super-node. If v is a super-node in V represent ing 


graph G, = (VA V)); then the node v appears with the name of the 


1? 
represented graph enclosed in parentheses. Thus, v(G,) is an element 
of V. The set of arcs A is the same as defined before. a. is an 
element of A if a. is a simple arc or super-are in G. Additional 
notation V replacing the mapping A indicates all incident nodes of 
all arcs. 

The sequence of characters V(a) is defined for each arc a. The 
characters consist of parentheses, brackets, commas and node names. 


The order of characters is determined in the following manner: 


V(a), the sequence of characters defining arc a in G, 
is defined using an ordered pair of sequences. 


V(a) = (fF, (@u)], [F,() 1). 
where 


u is the starting node in G of arc a, and 
v is the ending node in G of arc a. 


The sequence of characters represented by Ee) is defined 


recursively: 
v if v is a simple node. 


HD, 7 ene ua if v is a super-node. 


i evemewoestaneine node of arc a; then v* is the 
starting node of a in the graph represented by v. 


If v is an ending node of arc a, then v' is the 
ending node of a in the graph represented by v. 


The recursion must gi..> a finite sequence of nodes, because every arc 
eventually starts or cnds at a simple node. 
If V(a) = ({u,,u,,u3, aor uJ, [V) Vo 2V3> oe v;]), then a, U)> 


and Vv, are in the same graph. uy and Vv, are the starting and ending 
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super-nodes of the super-arc a. u, and vs are the starting and ending 
simple nodes of arc a. UL and v, are in the subgraphs represented by 
U4 and Vind Roe ose td and £ = 2,354,...,4. 


The graphs shown in Figures 4, 5, and 6 demonstrate the use of the 


super-node concept. First, a graph G is defined in Figure 4. 





Figure 4. A detailed graph 


Then, replacing the induced subgraph determined by Vo» V3» Vy> and Ve 


with a super-node Vil gives the graphs G,> the detail graph represented 


by super-node Yar and Gi, the altered graph G. Arcs ag, ay and a. are 
part of the subgraph G,- Graphs G' and G, are shown in Figure 5. 





V2 2 V5 
Q4 V, 
V3, Lee 
(a) Graph G, (b) Graph G 


Figure 5. A graph G containing a super-ncde 
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The following information not shown about the super-arcs is 
maintained in the sequences V(a): 


Super-are a, not only ends at v,, in G', but also at v, in G,- 


1 11 2 
In a Similar manner, arc ay ends at Yu in G’ and at V4 in G,. 
Super-are a, starts at v,) in G' and v, in G,. 
Super-arc a, starts at v,, in G' and ve in G,. 


Noting that Yuq and v5 are the ending nodes of two arcs which 


Start at v and are also the starting nodes of two arcs which end at 


i ee 


Ves graph G" is constructed by representing with super-node Vo] the 
induced subgraph G, consisting of Yq and V5. Since all arcs and 
super-arcs of G' start or end at Viz OF Va» they all become super-arcs 
in G". The resulting graphs arc shown in Figure 6. 
q, ds ai 
G “A i “ ; ° 
Vi) = ey Eo » 6 
V, 
at 
ut 
(a) Graph G (b) Graph G2 
Vo, represents Gp vi represents G 
Os 
Vo o—_— V5 
4 
V3 ds 4 


(c) Graph G, 


Figure 6. A system of graphs containing super-nodes 
and super-arcs 
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The following information 


ends 


Super-arc ay 


Super-arc ends 
Super-arc ends 
Super-arc Star 
ouper-arc star 


Super-arc star 


not shown is maintained in the (a) sequences: 


at V5 4 1 0 Chae Yay in Go and Vo in G,. 
ne V1 in G", Vay in G, and V3 in G,- 
at Voy in G" and V5 in G, - 

ts at vo) Pianos Yai in G, and Ve in G)- 
fs at V1 in Gl Yui in Go and Vi in G,- 
ts at vy, in G" and vz oy G, - 


Table V(a) shows the sequences BW) for the system of graphs in Figure 


6. The sequences V(a) of 


sequences contain all inf 
graph G in Figure 4. 
Vv 
V 


4079 92a > 


Vv a 


V an,a2a 


3 


2 


V a 


V 


eb) 


a 


3 


a 


< 


a 


1 
2 
Ss 
hs 
5 
6 3a 


th 
5 
3 
6° 7 
Ss, a 
eit 
11 
ai 
Ll 
on 
2A 
oi 
OT 
21 


21 


Vv 


V 
V 
V 


V 


V 


V 


(a) The s 


the system are in Table V(b). These 


ormation necessary to construct the original 





, F_() 
ag sal» and Ag a 
l and a. Vo 
and ae V3 
and ae Uy 
and as Ve 
and Ag Ve 
9 and Ag Vo 
ai ee oe o> 
ay Site ane es 
46 EE ee ea 
ay metas) ee ils 
a ee ae oe ee 
29 ee or aa 
*6 Cee ie ea oe ne A 
a Sey iS en es 
“8 oie oe 7 
ao ea ee 217 
equences ley) for the graphs 
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a V(a) 

aml (Ivy ls [¥542%449V2) 
a2 (Ivy ] [V9 42%. 2¥3)) 
a, (Ivo], vs) 

a, (Ivg], [vg1) 

as ([v,], [v,]) 

“6 Cv eV pryl> Ive) 
“7 CIV Vy p¥51> Ive) 
ag (Iv, 1, [v,,.v7)) 

*9 eh 7 Ge 


(b) The sequences V(a) for the graphs 


Table V. FW) and V(a) for the graphs in Figure 6. 


F,. CELLS AND POINTERS 

The internal representati 1 of the user's graphs are in the form of 
Seeise wiich is composed of cells. A cell is a logically contiguous 
block of computer storage locations. The storage locations in a cell 
are divided into one or more fields. Each cell has a unique address 
which is the storage location of the first field in the cell. Each 
field of a cell has a unique displacement from the first field. The 
address of a field of a particular cell is the address of the cell 
plus the displacement of the field within the cell. A field may be 
used to store characters, real or integer numbers, or addresses of 
other cells. A storage location (not necessarily in any cell) is 
Seredsa pointer if it is used to hold the address of a cell. fhus, 
a cell may contain fields used is pointers (i.e., a cell may point to 
several other cells or itself‘). A unique pointer value is reserved to 
indicate that the pointer with this value does not point to a cell. 


This value is called the NULL value and is represented by the character 
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A. A variable is a symbolic name representing the contents of a 
unique storage location not in any cell. 

Consider a list representing a deck of cards. Each cell represents 
one card. Each cell consists of three fields named DENOM, SUIT, and 
Nee. DENOM is the denomination of the card (2, 3, ... king, ace), 
SUIT is the suit (club, heart, etc.) and NEXT is a pointer identifying 
the cell which represents the next card in the deck. TOP, LAST and P 
are unique pointer variables. To aid in interpreting the list in 
Figure 7b, a key is given, Figure 7a, to show the relative position 
of the fields in a drawing of a CARD cell. The values of pointers are 
indicated by arrows. Note that the NEXT arrows start in a cell and 


point to the boundary of the next cell. 


eS 





(b) A deck of cards 


Figure 7 A list representing a card deck 


i 





HOPeis a pointer variable which identifies the top card of the deck. 
TOP's DENOM is “ace"'. We may set P (another pointer variable) equal 
to TOP's NEXT as shown. Then P's DENOM is "king''. P may be moved on 
down the deck by setting P equal to P's NEXT. Finally, P will equal 
IAST. Note that IAST's NEXT is NULL indicating the end of the deck. 
One need not be concerned with assigning particular storage 

locations to variables and cells. Higher level programming language 
compilers accomplish this clerical task. The important point is that 
each variable is a different storage location not among those com- 


prising cells. 
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Lit. THE DESCRIPTION OF THE PROGRAM 


A. GOALS OF THE PROGRAM 

As it is implied by the title, all of the goals of the system may 
be summed up as follows: To provide a man-machine interactive system 
used in solving directed graph problems. 

To be truly interactive, the total system (hardware and software) 
must keep the user's mind on the directed graph problem. Use of a 
computing system with a cathode ray tube display unit allows instan- 
taneous communications between the user and a program. Also, the 
program must be efficient; the system must process the commands as 
fast as the user can issue them. Indeed, the user realizes that an 
on-line system is to be responsive and becomes irritated when it is 
not. Peak loads on a multiprogrammed computing system will cause a 
lag in response time no matter how efficient the software is. Since 
the on-line user becomes irritated upon waiting four seconds or more 
for the machine to avail itself for the next eersnde the on-line 
system should frequently test the time elapsed from the entry of the 
last user command. If the elapsed time is approaching four seconds, 
processing should be interrupted to display an apologetic message to 
the user explaining the cause of delay. 

It has been observed that users of on-line systems become irritated 
when obviously needed commands are not available or selection of commands 
is a complicated process (e.g., searching a list of operations for a 
numeric code to be entered). The user's train of thought is forced to 


leave the realm of the problem to become involved with the inadequacies 
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of the system. Therefore, this system is designed to use the light 
pen detection facility and a complete list of alphabetic mnemonic com- 
mands displayed on the screen of the display unit--the simplest and 
quickest means available for communications between the system and the 
user. 

The on-line user realizes that the system is merely a device 
existing to serve him; therefore, he should not be treated rudely by 
the system. If he is, he will choose not to use the system, or if 
forced to, will spend many an unhappy hour with it--definitely not a 
characteristic of a good interactive system. The tone of messages to 
the user incorporated in this system is that of a courteous laborer 
working for the user. 

Conserving the resources of the user should be a goal of any system, 
on-line or not. [It is assumed that the multiprogrammable computer will 
have three or more jobs to work on while not processing commands from 
the user. Thus, the facilities of the computer are not wasted by 
having it wait for the user to enter a command. Also, use of a pro- 
gram overlay feature decreases the amount of core storage allocated to 
this system. 

This system is designed to use dynamic storage eaiige at tan instructions 
to construct a PL/I list structure representing the user's graphs. The 
use of this feature not only conserves storage, but lends the use of 
the system to a variety of graph theory applications. User-written 
routines are linked to the system thus specializing it for use with a 
particular application. The user, through the routines he provides, 
may associate additional fields with nodes and arcs (e.g., resistance, 


inductance, etc.}. He also provides analysis routines which access the 
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list structures. System routines are provided to aid the user in his 
analysis and display of his results. 

Many short sessions with a system is psychologically more pleasant 
than fewer extended sessions. Therefore, directed graphs may be saved 
as a sequential data set at the end of a session. This data set may be 
used to initialize the system at the beginning of the next session. 

Because of the interactive nature of the system, it lends itself 
to on-line design of directed graphs. Thus, the user may modify the 
eraph, call his analysis routines and fron: the output of the analysis, 
make more modifications, and so forth until the optimal design is 
reached. He may prepare before his first session a card deck from 
which the system will obtain the initial graph structure. ‘The card 
format is designed to be relatively free of restrictions. To fully 
utilize the interactivity of the system, corrections for errors found 
in the card deck are requested from the user on-line. 

In conclusion, the system designed is flexible--to meet the desires 
of a variety of users. It is on-line--to take advantage of man's 
heuristic nature. And, it is courteous--to make use of the system 


pleasant. 


B. SYSTEM DESIGN 
Because the user must program his own analysis routines and link 
them to the system, a discussion of the overall design is presented. 
Basically, the user is provided with a PL/I main program and a 
series of subrou:.ines which perform three functions: 
1) Drive the display unit. 
2) Generate and modify the user's list-structured directed graphs. 


3) Call user analysis routines. 


ZS 





When a function key at the display unit is pressed, the system calls 
the user routine named BUTTONS, Since the system variables are 
@eclared "EXTERNAL," the user has access to their current values and 
can use them in his analysis. The user may display the results of 
his analysis by calling a system routine to save the current display 
preparing it for his use; or, by calling call another routine which 
displays a "page'' of user-generated text. Use of either procedure 
allows him to use the light pen, function keyboard, and alphanumeric 


keyboard for his own purposes. 


C. THE LIST STRUCTURE 

The PL/I List Processing features are used extensively to construct 
a representation of the user's directed graphs in core memory. Allo- 
cations of two based structures which represent two types of cells 
are linked together to form the directed graphs. NODE is the level l 
identifier of the structure used to represent nodes of the graph and 
ARC is the level 1 identifier of the structure used to represent an arc. 
Each allocation of either structure is called a cell. The structures 
are declared as follows: 


DECLARE 1 NODE BASED (PP), 
2 LABEL CHARACTER(4), 


Zee EOUNTEI.. 


2 DOWN POININR, 


1 ARC BASED (P-ARC), 
2 SON POINTER, 


2 MORE POINTER; 
To avoid confusion, some of the level 2 elements in the structures are 


not shown here. They will be explained later. 
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The integer 1 preceding NODE and ARC indicate that NODE and ARC 
are symbolic names representing all of the fields of one of the cells. 
The integer 2 beginning the lines under 1 NODE and 1 ARC establish 
symbolic names and displacements for the fields in the NODE; likewise 
for SON and MORE in the ARC cells. The word BASED instructs the PL/I 
compiler to generate code which will dynamically allocate core storage 
upon the execution of the ALLOCATE statement and will free storage 
upon the execution of the FREE statement. 

The NEXT and DOWN fields in NODE cells and SON and MORE in ARC 
cells are used as pointers, that is, they are used to hold addresses 
of unique cells. By program convention, the DOWN and SON fields always 
point to ARC cells. This makes traversing the lists less complicated. 

A NODE cell is allocated for each node and an ARC cell is allo- 
cated for each arc of a graph. The DOWN pointer of the NODE cell 
points to a list of ARC cells. The MORE field links the list of ARC 
cells similar to the way NEXT linked the CARD cells in Figure 7. All 
of the arcs represented by the ARC cells in a list start at the same 
node. The SON pointer of an ARC cell points to the ending node of 
the arc. Figure 8 shows a list structure demonstrating the use of the 
two fields in each cell. It is called a partial list structure because 
not all fields are shown. The letters appearing immediately above each 
ARC cell serve merely to identify the ARC cell; only node labels are 
steered in the list structure. | 

From Figure 8, we may make the following observations: 

1) ARC cell Al represents arc a.,. 


ARC cell A2 represents arc ao - 
ARC cell A3 represents arc a... 
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(c) Partial list structure of graph Gl 


Figure 8. A graph GI and its list structure 


2) The label of a node is stored in the LABEL field of the 
NODE cells. 


3) The DOWN pointer of NODE cell labelled V3 has a NULL value 
indicating that there are no ares starting at V3 - 


4) There is no unique order for arcs appearing on the list of 


ARC cells. For instance, ARC cell A2 may have come directly under NODE 
cell Vl and ARC cell Al under ARC cell A2. 
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To facilitate processing, the NODE cells are put into a list 
linked by the NEXT pointer and another NODE cell called the graph 
header cell is added in which to store the name of the graph and to 
provide a starting point for processing the graph. Use of the NEXT 


pointer and addition of the graph header cell is shown in Figure 9. 


V; 
q, Go 
G3 
Vp V3 


(a) A graph GI 


NODE cell ARC cell 








(c) List structure of graph GI 


Figure 9. A graph Gi and its list structure 
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Because many graphs may be in core simultaneously, a list of ARC 
cells linked by the MORE pointer is maintained with the SON pointers 
identifying the graph header cells of the graphs in core. The system 
pointer variable SUPLIST (mnemonic for super list) points to the top of 


this list. Figure 10 shows the use of these ARC cells and the pointer 
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(b) T.ie list structure 


Figure 10. A list structure showing the use of 
the system pointer variable SUPLIST 
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SUPLIST is set to the NULL pointer value if no graphs are in the 
system. Note that through the variable SUPLIST, the system and user 
routines can access all of the graphs active at any time. 

To store the information necessary to indicate that a cell of a 
graph represents a super-node or super-arc, some additional fields are 
needed in the cells: 


DECLARE 1 NODE BASED (PP), 
2 LABEL CHARACTER(4) , 


2 NEXT POINTER, 
2 SNODE POINTER, 
2 HINFO POINTER, 


2 DOWN POINTER, 


1 ARC BASED (P-ARC), 
2 SON POINTER, 
SARC POINTER, 
AINFO POINTER, 
PSARC POINTER, 
PAINFO POINTER, 


NO NO NO PO 


2 MORE POINTER; 

Consider Figure lla and b. Graph G2 contains a NODE cell V11l 
which is a Super-node representing a copy of graph Gl. SNODE of 
the super-node cell points to Gl's graph header cell, identifying 
the graph that it represents. An ARC cell labelled IH is added to 
the ee of ARC cells pointed to by the DOWN pointer of Gl's graph 
header cell. An ARC cell will appear on this list for each copy of the 
graph currently in the system. “his ARC cell is called an interface 
header cell. Its SON field points to the super-node's NODE cell. Its 
MORE field points to more interface header cells of Gl, NULL in this 
case. Its AINFO field points to a list of interface ARC cells. Figure 
lid shows the igtrace betweei. a super-node cell V1ll, a graph header 


cell Gl, and an interface header cell IH. The characters "(XXX)" in 
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the drawing of a list indicate that the field is a pointer identifying 
the cell labelled XXX. All ARC cells have a label representing its 
address just above it. 

The list of interface ARC cells form the "interface" between a 
Super-node and a copy of the graph. This interface concept allows 
many copies of the graph to exist without using computer storage for 
a separate copy of the graph for each super-node. Also, processing 
time may be reduced significantly. Consider the analysis of a PERT 
network representing the construction of a fifty story office building. 
A graph F may be designed to represent the activities necessary for con- 
structing one floo:--one node in F for each activity. Then, another 
graph B which represents construction of the entire building is 
designed containing among other nodes, fifty super-nodes each repre- 
senting the const’ uction of a floor, graph F. The PERT routine would 
first determine critical path values for graph F and associate these 
values with each super-node representing graph F. Then, graph B is 
analyzed by the PERT routine. 

If the graph F, on the other hand, were duplicated fifty times and 
merged into graph B, the analysis of graph F would occur fifty times. 
It is apparent that a similar saving in time and storage would be 
made by applying this concept to other problems (e.g., the analysis 
of an electronic circuit containing many "copies" of a simple amplifier). 

The representation of the last piece of vital information--with 
which nodes in the graph Gl of Figure 11 are the super-arcs in G2 
incident--is now unveiled. First, the ARC cells which start or end at 
Yai in G2 are super-arcs. Their SARC and AINFO fields were left blank 


in Figure 11. Also, the AINFO field of the interface header cell points 
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to a "list of interface ARC cells". This list and the empty fields 
of the super-arc cells define with which nodes the super-arcs are 
incident. 

There is one ARC cell in this list for each super-arc starting or 


ending at v An ARC cell in G2 is denoted as representing a super- 


1 ie 
arc by setting either its SARC or AINFO pointers (or both) to point to 
a unique cell on the appropriate interface list-~--depending on the 
starting and ending nodes in G2. 

If the ending node is a super-node, then the SARC field of the 
Super-arc cell is set to point to an interface ARC cell. The inter- 
face ARC cell is on the list of interface ARC cells identified by the 
HINFO field of the ending super-node cell. This interface ARC cell's 
SARC field points to the node in Gl at which the super-arc also ends. 

If the starting node is a super-node then the AINFO field of the 
super-arc cell points to an interface ARC cell. This interface ARC 
cell is on the list of interface ARC cells identified by the HINFO 
field of the starting super-node cell in G2. The AINFO field of the 
interface ARC cell points to the super-arc's starting node in Gl. 

If both the starting and ending nodes of a super-are are super- 
nodes, then pointers are set as described above. The SON field of 
an interface ARC cell points to its interface header cell. Figure 12 
shows the linkage between the super-node V11, super-arcs Al and A2, and 
the interface ARC cells IAl and IA2. Cells labelled IAn are interface 
ARC cells, Al and A2 sre super-arc cells, and the cell labelled IH is 
an interface header cell. 

An example showing a three graph system with a super-arc between 


two super-nodes, a super-arc starting at three nodes (each in a 


eZ 





(b) Graph Gl 


(a) Graph G2 
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Figure I2. A list showing an 


interface ARC cell list 
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different graph), and showing multiple copies of a graph appears in 
Poeure 13. 
Graph G3 = (VA 5V3); 
where 


V, = {v,,(62),v,5(GL)$ 
A, = fa, $ 
V£4g) = V5 oVqqoVyls E¥yo Vol) 
Graph G2 = (Vo Ag 2Vo) > 
where 
Woes iv, sv, ,(G1)§ 
Ay = tags 
a3) = (Iv), [v1>¥3)) 
Graph Gl = (V, >A, .V)); 
where 
v, = {v,,v,,¥33 
Ay = {a,.a5} 
Via) = ([v,], [v]) 
Vfan) = Cv], [v5 )). 
Since super-arcs may start (or end) at several super-nodes, each 
in a different graph, the PAINFO (and PSARC) field is needed in which 
to store this information. The following set of rules determine the 


number and field values of interface arc and header cells: 


1) There exists an interface header cell IHij under Gi's 
graph header cell for each super-node SiGieeepresenting graph Gi. 


2) IHij's SON points to a unique super-node SNij representing 
graph Gi. 


3) IHij's AINFO points to a list of interface ARC cells IAijk. 


4) An interface ARC cell exists for each super-are eventually 
starting or ending at SNij. 


5) IAijk's SON points to IHij. 
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Figure 13. Three graphs an the list structure 
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6) IAijk's SARC points to a node Nip in Gi if the kth super- 
arc in the system eventually incident with node Nip ends at node Nip. 


7) IAijk's AINFO points to a node Niq in Gi if the kth super- 
arc in the system eventually incident with node Niq starts at node Niq. 


8) IAijk's PSARC points to TAlmn if 
a) IAijk's SARC points to a super-node SNlm in Gi. 
b) The super-are associated with IAijk also ends at SNlmn. 
c) The kth super-are incident with node Nip is also the 
nth super-arc incident with SNIlm. 
9) IAijk's PAINFO points to IAlmn if 
a) IAijk's AINFO points to super-node SNlm in Gi. 
b) The super-are associated with IAijk also starts at SNlm. 
c) The kth super-are incident with Niq is also the nth 


Super-are incident with SNIm. 


10) Otherwise, the fields in the interface ARC and interface 
header cells (except MORE) are set to the NULL value. 


Figure 13d shows the list structure reflecting the use of interface 

ARC and interface header cells. Note, for example, that the starting 
node of A4& can be traced (through IA1) to V11, then (through IA3) to 
Vl. Also, given a graph, say Gl, one can immediately locate all 
super-nodes which represent the graph, V12 and V1l, and from there, the 


Super-arcs which start and end at nodes in the graph, A4 and A3. 


D. USER ROUTINES 

Because the system is not designed for a particular application, 
the task of applying it to an application is left to the user. The 
routines the user must provide are application-oriented and are 
divided into two classes. One class handles user-defined fields and 
cells. The other class consists of analysis routines. System routines 
are provided to assist the user in the programming and implementation 
of his routines. Also, system variables are declared "EXTERNAL". 


Therefore, their values may be accessed at any time. 


a 





User-defined fields and cells are set up by the system in the 
following manner. First, each NODE cell of the directed graphs has 
four fields which are available for his use. Each time a node is 
added to or deleted from a graph, a user routine named N_USER is 
called. « pointer to the cell and a variable set to one for add or 
two for delete is passed to this routine. This routine may then use 
a system routine to retrieve information from the display device on- 
line to set the fields reserved for his use. The following fields 
are set aside in the NODE cells: XCOR and YCOR are FLOAT BINARY(21), 
ON_OFF is BIT(2), and USER is a POINTER. The user may design and 
allocate storage for his own cells to hold more information related 
toa node and set USER to address his cells. This routine is called 
just before a node is deleted so that he may free the storage used 
for any of his cells. 

Likewise, one pointer field in each ARC cell may be used: USERA. 
N_USER is called in a similar manner; however,the calling integer 
argument is set to three for add and to four for delete. 

Thus, during analysis, the user may access these values stored in 
the cells, use them for computations and perhaps re-store new values 
to be displayed later. | 

After his graphs have been put into the system, he may press a 
function key. Another user routine is called: BUTTONS. The number 
of the function key pressed, 0 through 31, is passed to this routine. 
He may then perform an analysis of the graphs, display textual infor- 
mation using, if desired, a system routine DISPAGE, or cause a printed 
output of one or more graphs--again, optionally using another system 


routine P_ARCS. 
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The last routine named ANALYZE must be provided. It is invoked 
by positioning the light pen on the displayed option: ANALYZE. 
Again, he may initiate any of the actions above (including calling 
BUTTONS with a dummy function key number!). 

The user's manual in Appendix A contains a detailed discussion of 
the system. The program listing of an initial implementation on the 


IBM 360/67 appears in the Computer Program Section. 


E. A SAMPLE ALGORITHM 

To demonstrate how the list structure can be traversed, algorithm 
P is shown which will construct the path reachable set Pay. given 
two arguments: N, the length of path progressions considered and PN, 

a pointer identifying the NODE cell representing v. 

First, an algorithm is shown which checks an array of pointers to 
see if the last one is a duplicate of any of the pointers above it. 
This algorithm, named CHECK, will be called in algorithm P to determine 
whether the arc progressions generated in P are also path progressions. 
In the algorithm CHECK, POINTERS is an input one-dimension array of 
pointers. JIAST is the index of the last element in the POINTERS array. 
POINTERS (1) is the first element. RESULT will be set to one if the 
last element in POINTERS is not in the array twice; it will be set to 
two if the last element is duplicated. 


ALGORITHM CHECK(POINTERS , LAST, RESULT) 


aR SoG bec | 

2. IF LAST is less than 2 THEN RETURN 

Se — | 

4. IF POINTERS(I) equals POINTERS (LAST) 
then GO TO STEP 8. 

Peaele< Po 1 

6. IF I equals LAST THEN RETURN 

je GO TO STEP 4. 

8. RESULT <—— 2 

9. RETURN 
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Algorithm P constructs all possible arc progressions of the 
length desired. WSEQ is a one-dimension array of pointers identifying 
the arc progression. IW is an integer indicating the last element in 
WSEQ used. Each time an arc is added to WSEQ, algorithm CHECK is 
called to determine whether the arc is already on the list. If so, 
the arc progression is not a path progression; thus, the algorithm 
explores another arc progression. If a progression with no repeating 
arcs contains N arcs then the ending node of the last arc in WSEQ (if 
not equal to PN) is an element of the path reachable set desired; the 
pointer to its NODE cell is added to the output array of pointers 
RSET. IR is similar to IW, indicating the last element in RSET. 

The pointer array SAVEP and the integer array SAVEN stores pointers 
to ARC cells and the current value of IW respectively. These arrays 
are used to construct another arc progression. The index of the last 
element of both of these arrays is stored in the integer variable IS. 
ARC is a pointer variable identifying an ARC cell. ND is a pointer 
variable identifying a NODE cell. 

ALGORITHM P(PN,N,RSET, IR) 
ieee U 
iZeaeio << 0 
earth =< © 
I4. ARC <— _ PN's DOWN 
I5. IF ARC = NULL THEN RETURN 
Sl. IF ARC's MORE = NULL THEN GO TO STEP Wl. 
Sop ogseee TCest a) 
S63, OAVEP(IS) <—~— ARC's MORE 
So SAVEN( TS )<—— IW 
Kit <-——- ARG’ s SON 


W2. IW<— IW+t1 
W3. WSEQ(IW) <—— ARC 
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Tl. CALL CHECK(WSEQ, IW,RESULT) 

i7-eeee KEoUbLE = 2, 7HEN GO TO STEP Pl. 

T3. IF IW = N THEN GO TO STEP Al. 

T4. IF ND's DOW.; = NULL THEN GO TO STEP Pl. 
ioe oko -s— ND's: DOWN 

foes) GOeLO STEP Si. 

Pl. IF IS = O THEN RETURN 

P2. ARC <—— SAVEP(IS) 

Poe lk =——— SAVENCIS ) 

Ee looses = 

Poco, LOvSTEP Si, 

Al. IF WSEQ(IW)'s SON = PN TIEN GO TO STEP Pl. 
eR Ro | 

PO ee Ronn ih) <——— WSEO(IW)'s SON 

A4. CALL CHECK(RSET,IR,RESULT) 

FOP iveReoUliie=) | THEN GO LTO STEP Pl. 

A6é. IR <—— IR -l 

Mie. GOTO STEP Pl. 

Steps Il through I5 initialize the system; Sl through S4 save 
pointers necessary to constru the next arc progression to be inves- 
tigated; and Wl through W3 add an arc to the arc progression in WSEQ. 
Steps Tl through T6 check the progression to insure that no arc is 
duplicated and if N arcs are in the progression, then control is 
transferred to step Al. Pl through P5 resets ARC and IW so that 
another progression is checked. If no more are to be checked, the 
algorithm terminates returning RSET and IR. Al through A7 check to 
insure v, # ey anaes i 106,, Very is added to RSET permanently if not 
already in RSET. The next progression is then explored. 


This algorithm can be modified to return the cumulative (path) 


reachable set or the (path) reachable set of a sequeice of nodes. 
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IV. CONCLUSION 


The system designed provides an input/output interface between the 
directed graph problem and the computer. Since pictures of graphs 
often are heuristically useful in obtaining solutions to some problems, 
a graphic display unit is used on which to ee a drawing of the 
graphs. Also, through the unit's light pen and function keyboard, the 
user may interact with the graphs--thus providing an on-line graph 
design capability. Upon specified interrupt actions, user-written 
analysis routines are invoked which have access to the list structure 
built and maintained by the system to represent the directed graphs. 
System routines which may be invoked by user-written procedures are 
provided to aid in the design and implementation of the system for a 
specific application. 

Because the system is not designed for a particular application, a 
non-trivial programming task is left to the user. Also, the fact that 
the storage for the list structure is dynamically allocated means that 
the user-written programs should be written in either PL/I or assembler. 
List processing, in itself, usually is not undertaken by the novice 
programmer. Therefore, the field of probable users is somewhat limited. 

The PL/I language of the IBM 360/67 restricts the total amount of 
storage dynamically allocated to based structures to TG. bytes. There- 
fore, when this storage is filled, no more nodes or arcs may be allocated. 
Hence, a sub-system handling the temporary storage of graphs on a mass 
storage medium is a necessary addition to the system to allow the 


analyses of large graphs. 
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Also, the number of nodes and arcs displayed is limited by the 
size of the buffer of the IBM 2250 Display Unit. A 4K, 8K, 16K, or 
32K byte buffer may be installed in the 2250. A 4K buffer allows 
approximately twenty nodes and arcs to be displayed at any one time. 

At the time of publication of this paper, many IBM 360/67 systems 
are replacing the IBM Operating System with IBM's TSS which does not 
support PL/I or the 2250. However, IBM has announced that both will 
be supported eventually. Random access is not to be supported under 
TSS. This may severely restrict the use of a mass storage medium for 
temporar\ storage of directed graphs. 

Other graph theoretic systems have been designed. An extension to 
ALGOL was designed by S. Crespi-Reghizzi and R. Morpurgo [2] to allow 
specification and manipulation of graphs in the source language. It 
is not interactive, does not allow the representation of many nodes by 
one node and does not provide a display capability. It does use 
dynamic storage allocation and allows directed and undirected graphs. 
Real numeric fields may be associated with nodes and arcs. 

Michael S. Wolfberg [3] designed and implemented an interactive 
graph theory system on the IBM 7040 with a DEC-338 graphics terminal. 
The abstract from his paper indicates thet his Setar provides , in 
addition to the graph manipulation perane of this system, the capa- 
bility of entering analysis routines from the terminal. The abstract 
did not indicate whether dynamic storage allocation or the super-node 
concept is used. 

A system used in manipulating trees was designed and implemented on 
the IBM 360/67 with a 2250 Display Unit by Claude Holifield [4]. His 
thesis was not available for comparison at the time of publication of 


this paper. 
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APPENDIX A 


USERS ' MANUAL 








Interactive Graph Reduction and Analysis Program 


USERS' MANUAL 


by 


Lieutenant (junior grade) James W. Thomas, USN 
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Figure l 


The IBM 2250 Display Unit. Using the function keyboard on the left, the alphanumeric keyboard below 
the screen, and the light pen, the user may interact directly with the system. 








I. INTRODUCTION 


The Interactive Graph Reduction and Analysis Program provides the 
user with a software package which aids in the input specification of 
directed graphs to computer core storage, allows on-line modification 
of the graphs, and submits a PL/I list structure representing the 
directed graphs to user-written analysis routines. 

The package is written in version 4.3 of IBM's PL/I (F) program- 
ming language and runs under release eighteen of the IBM 360/67 
Operating System. It uses the IBM Graphic Subroutine Package (Program 
Number 360S-IM-537) to support the IBM 2250-1 Display Unit and executes 
in less than 200K of core storage. 

The system allows on-line design of directed graphs. The user may 
input a directed graph through the display unit, then request his 
analysis routines to be invoked. Output from the analysis may be 
displayed and used by him to determine changes he may want to make in 
the graph. This interactive process may continue indefinitely. 

The user should be familiar with the following IBM publications: 


IBM System/360 Component Description: IBM -2250 Display Unit 
Model 1. Form A27-2701 


IBM System/360 Operating System Graphic Subroutine Package 
(GSP) for FORTRAN IV, COBOL, AND PL/I. Form C27-6932 


IBM System/360 PL/I (F) Language. Form C28-8201 


IBM System/360 Operating System PL/I (F) Programmer's Guide. 
Form C28-6594 


IBM System/360 Operating System Linkage Editor and Loader., 
Form C28-6538 


IBM's Job Control Language cards needed to execute the system are 


shown in the Computer Program and Computer Output sections of this paper. 
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II. DISPIAY FRAMES 


At the IBM 2250 Display Unit, the user works with four system- 
generated pictures or display frames. Each frame handles part of the 
total system task. The frames are listed below with a brief description 


of each. They are discussed in detail in Chapter III. 


A. INPUT MODE SELECTION FRAME 

This is the first frame displayed by the system. It allows the 
user to choose the initial input mode: cards, magnetic device or the 
display unit. The user utilizes the light pen to choose the mode of 


input desired. 


B. GRAPH MANIPUIATION FRAME 
This is the frame used to display and alter the directed graphs. 
Graphs may be input through this frame. User-written analysis routines 


are called from this frame. 


G. GRAPH SELECTION FRAME 

Often many graphs may be in the system at any one time. However, 
only one may be displayed in the Graph Manipulation Frame. If the 
user wants to display a graph, this frame presents the names of all 
graphs in the system and allows the user to detect with the light pen 


the graph he wants displayed on the Graph Manipulation Frame. 


D. USER INPUT/OUTPUT FRAME 
This frame is utilized to display a "page" of text generated by a 
user-written routine and return light pen, function keyboard and alpha- 


numeric keyboard information to the calling routine. 


a 
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Figure 2 


The Input Mode Selection Frame. Positioning the light pen on option 


1, 2 or 3 relays the user's request to the system. Above, option Ze 
CARDS, had been selected. 
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III. DISCUSSION OF THE DISPIAY FRAMES 


A. INPUT MODE SELECTION FRAME 

This frame displays the three possible sources of input to the 
system. The user selects a source by pointing the light pen at 
either CARDS | 

MAGNETIC DEVICE 

or BOOB TUBE. 

Depressing the foot pedal activates the light pen detection facility 
and the selection is transmitted to the system. If the light pen is 
not directed at one of the three options when the pedal is pressed, 
the user is Betieiad By the replacement of the row of asterisks at 
the bottom of the display with the message, "INVALID OPTION. ..TRY 
AGAIN," 

If CARDS is selected, the system reads a "packet" of data cards 
submitted mee rite SYSIN of the job step which invoked the execution 
of the system. The data card format is described in a later section 
of this manual. . 

If MAGNETIC DEVICE is selected, the system reads a similar data 
packet created by a previous run. This file is named MAGINPT and is 
a sequential card image file on any magnetic mass storage coon 

If BOOB TUBE is selected, the system displays the Graph Manipulation 


Frame for on-line input of graphs. The user may input a graph through 


the CARDS option, then select this mode to change the graph. 


B., GRAPH MANIPULATION FRAME 
This frame is divided into three regions. One region, along the 


right-hand margin of the tube, is used to display a list of options the 
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Figure 3 


The Graph Manipulation Frame showing 49 possible node positions 
indicated by four X's. The frame is ready for input of a graph to 
the system. Note the four underscores under "NAME". These are 
replaced by the graph name. The options appear to the right of the 
mode positions. In a recent change to the program, "SAVE" replaced 
"END" in the option list. 
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user may select with the light pen. These options or commands direct 
the system in manipulating the graphs. Another region is used to 
display messages to the user. The third and largest region is used 

to display a graph consisting of octagons or nodes and arrows or arcs 
between octagons. Inside each node is a four-character label assigned 
by the user or a default label '"NNxx" where xx is a unique decimal 
integer. The first two characters are restricted to alphabetic 
characters. 

The options allow the user to add and delete nodes and arcs, move 
a node from one of the forty nine possible positions to another, 
combine some of the nodes displayed into a graph replacing them by a 
Super-node and to add nodes to graphs represented by super-nodes. The 
user may add and delete super-nodes and store a displayed graph, 
clearing it from the frame, so that a new graph may be entered. He 
may cause his analysis routines to be called at any time which will 
have access to ssystem pointer variables. A more detailed discussion 
of the options and their effects follows. 

As mentioned above, the Graph Manipulation Frame is divided into 
three regions: ‘The GRAPH DISPLAY AREA consists of forty nine possible 
locations where a node may be displayed. Each location is denoted by 
the display of four X's. If a node occupies a location, then the X's 
are replaced by the node label and an octagon is drawn around the label. 
Arcs represented by arrows may be displayed between any two nodes. 

The USER MESSAGE AREA is used to display messages to the user. 
Upon selecting an option, instructions are displayed in this area 
telling the user which actions are expected and what errors have been 


made. 
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Figure 4 


The option list of the Graph Manipulation Frame. The options provide 
the capability of altering the graph displayed in the frame. The 
options are numbered here to provide a reference for the description 
of the options in Chapter III. Note that only lines numbered above 
may be detected by the light pen. 
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The OPTION AREA is used to display options that the user may 
select with the light pen. Any of the textual lines preceded by an 
underscore in the option list may be detected by the light pen. 

Those lines are numbered in Figure 4. The user may make the follow- 
ing option selections: 

1. ADD A NODE 

Selection of this option allows the addition of a node (simple 
or super-node) to the graph currently displayed. If the screen is 
clear and the graph name (appearing just below the text "NAME" and 
just above "OPTIONS:") is "__ _ _", then the system will insert a 
cursor in this graph name area under the first underscore and request 
in the user message area that the user enter a name for the graph. 
After the name has been entered, pressing any function key or gener- 
ating a light pen detect on the name will instruct the system to go 
on to the next step. The next step is the first step executed if the 
graph is already named. 

Now, the system will instruct the user to point the light pen 
at a vacant node position denoted by four X's. If anything else is 
detected (except CANCEL), the system displays an error message and 
requests the user to try again. When a valid available node position 
has been detected, a cursor is inserted under the first X and a new 
node label is requested. The characters typed by the user on the 
alphanumeric keyboard will replace the four X's. If the X's are not 
replaced, the system will provide a default name consisting of two N's 
and a two digit number. Pressing any function key or generating a 
light pen detect on the label will instruct the system to continue. 


An octagon will then be drawn around the label and the system will 
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Figure 5 


The Graph Manipulation Frame displaying graph SS 1. ADD AN ARC option 
had just been selected. Note the message to the user requesting the 
light pen (LP) to be positioned on the starting node of the arc to be 
added. 
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return to the ready state with the message displayed: SELECT AN 
OPTION OR USE DEFAULTS. The default options are described later. 

If the node is to be a Super-node, after entering the node 
label, a light pen detect on the SUPER-NODE option will cause the 
system to display the Graph Selection Frame, asking for a light pen 
detect on the name of the graph to be represented by the super-node. 
After this selection is made, the system will return to the Graph 
Manipulation Frame with the super-node added. 

2. ADD AN ARC 

Selection of this option allows the addition of an arc (simple 
or super-arc) to the graph currently displayed. if no graph is dis- 
played a message requesting the user to select ADD A NODE is displayed 
and the system returns to the ready state. If only one node is dis- 
played when this option is selected, a message alerts the uSer to 
select ADD A NODE before an arc may be added; loops are not allowed. 

If at least two nodes are on the screen, the user is requested 
to select (with the light pen) the starting node and the ending node 
For the arc. An arrow will be displayed between the two nodes, 
pointing from the starting node to the ending node. If either or both 
nodes are super-nodes, the graphs representing these nodes will be 
displaycd; the user will be requested to select a starting (or ending) 
node for the super-arc in these graphs and so forth until the user has 
eventually specified a simple node as the starting (or ending) node. 

3. SUPER-NODE 

Selection of this option when the system is in the ready state 

will cause the graph currently displayed to be saved and the screen 


cleared ready for the entry of another graph. If another data packet 
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Figure 6 


The Graph Manipulation Frame showing the result from moving NN 2 from 
its position in Figure 5 to its position here. The arcs were moved by 
the system. Note the REMOVE A NODE option had just been selected. 

The message to the user is requesting the light pen to be positioned 
on the node to be removed. 
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is waiting to be read, the system will return to the Input Mode 
Selection Frame. The user may select the desired mode. 
4. MOVE A NODE 
This option is included for aesthetic reasons only. Selection 
of this option allows the user to change the physical (displayed) 
location of a node on the screen. The list structure representing 
the graph is not altered. Upon selection of this option, the user 
will be asked to select the node he wishes to move, then to select a 
vacant node position. The node and all incident arcs will be moved 
to the desired position. 
5. REMOVE A NODE 
Selection of this option allows the removal of a node from the 
screen and the list structure. The user will be asked to indicate 
the node he wishes to be removed from the display and the list 
structure. Upon detecting a node (not a vacant position), the node 
and all arcs starting or ending at the selected node will be removed. 
The interface ARC cell list(s) will be updated if the node to be 
removed or any node incident with arcs removed are super-nodes. 
6. REMOVE AN ARC 
Selecting this option will cause the arc subsequently detected 
to be removed and the list structure to be updated. A detect on any~ 
thing (except CANCEL) will be flagged as an error and the user will 
be requested to try again. 
7. CANCEL 
This option may be used to return the system to the ready state 
cancelling the last option selected. For example, if the user detected 


the option ADD AN ARC and then realized that he had not added a node 
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Figure 7 


The Graph Manipulation Frame showing the result from removing NN 2 from 
its position in Figure 6. The arcs incident with NN 2 were removed by 

the system with the node. The user had just selected the REMOVE AN ARC 
option. Positioning the light pen on an arc would have removed it from 


the screen and the graph. 


61 





with which the arc was to be incident; he would then detect this 
option. The system would return to the ready state, cancelling the 
ADD AN ARC command. He would then add the missing node then add the 
arc. CANCEL may be used during the execution of any option. 
8. SAVE 

When the user is finished with a 2250 session, he may save 
some or all of the directed graphs that he presently has in the system. 
Selecting this option will cause the Graph Selection Frame to be dis- 
played along with the word "ALL" at the right-hand margin of the 
screen. Positioning the light pen on the word ALL will cause all 
graphs to be saved. The user may selectively choose with the light 
pen those graphs to be saved if he does not want all of them saved. 

When a graph is "SAVED", the system writes in a sequential 
card image output file named SAVEFLE one data packet representing 
the graph. This file may then be used as input file MAGINPT in con- 
junction with Ene MAGNETIC DEVICE option of the Input Mode Selection 
Frame to initialize the system for a later run. 

9. DISPLAY 

Selecting this option allows the user to re-display a 
previously saved graph. If after selecting DISPIAY, the user detects 
SUPER-NODE, the Graph Selection Frame will be displayed. The user may 
select a graph which is to be displayed in the Graph Manipulation 
Frame. He may then alter that graph. 

If, after selecting this option, the user positions the light 
pen on a node or arc, additional information will be displayed about 
that node or arc. Detecting CANCEL will return the system to the 


ready state. 
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If after selecting this option, the user positions the light 
pen on the name of the graph just above the text "OPTIONS:", infor- 
mation about the super-nodes representing the graph is displayed. 
Again, a light pen detect on CANCEL will return the system to the 
ready state. 

10. ANALYZE 

Selecting this option will cause the system to call the user 
procedure named ANALYZE. See the chapter 'User Routines" for further 
discussion. 

11. QUIT 

This option terminates execution of the system. Before 
detecting this option the user should save those graphs that he may 
want to use to initialize the system at the beginning of the next run. 


See the SAVE option of the Graph Manipulation Frame. 


C. GRAPH SELECTION FRAME 

When the user desires to display on the Graph Manipulation Frame 
a directed graph which is in the system but not currently displayed, 
or desires to add a super-node to a graph, he will be presented with 
the Graph Selection Frame. This frame consists of a list of graphs in 
the system; any one of which he may select with the light pen. If the 
last item in the list is '"*MORE'', then the number of graphs in the 
system is such that not all graph names may be displayed at once. If 
the desired graph is not on the list displayed, "*MORE" may be detected. 
This will cause another group of graph names to be displayed. When the 
last graph name has been displayed, "*END*" will be displayed instead 
Poe "XMORE." If the "*END*" is detected by the light pen, the first 


list of graph names will be re-displayed. A detect on the _CANCEL 
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option will cause the command requiring use of the Graph Selection 
Frame to be cancelled; the frame from which it was called will 


reappear. 


D. USER INPUT/OUTPUT FRAME 
The user may use this frame to display textual information and 
accept input from the alphanumeric keyboard, light pen or function 
keyboard. A call to the system routine which will display this frame 
follows: 
DECLARE LINE(52) CHARACTER(74) , 
(CODE,POS) FIXED BINARY (31), 
DISPAGE ENTRY ((52)CHAR(74) ,FIXED BIN(31), 
FIXED BIN(31)); 
CALL DIS PAGE (LINE ,CODE, POS) ; 
The characters in LINE(1) are displayed along the top of the screen, 
LINE(2) immediately below LINE(1) and so forth. The other calling 


arguments are explained in the chapter "System Routines and External 


Variables." 
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IV. SYSTEM ROUTINES AND EXTERNAL VARIABLES 


This chapter describes the system procedures and external variables 


which may be of value to the user in writing his routines. 


A. EXTERNAL VARIABLES 

1. SUPLIST (pointer) points to a list of ARC cells. Each ARC 
cell's SON field points to the graph header cell of a graph in the 
Be em. The cells in this list are linked by the MORE field of the 
ARC cells. This variable and the associated list may be used to 
access all the graphs in the system. 

2. TOP (pointer) points to the graph header cell of the graph 
currently displayed in the Graph Manipulation Frame. If a graph is 
not displayed, this pointer is set to the PL/I NUL: pointer value. 

3. MES (character(40)) is a forty-character string whose contents 


are displayed in the user message area of the Graph Manipulation Frame 


by calling the system routine UPMES2. 


B. SYSTEM ROUTINES 
1. ALLOC allocates either an arc or node cell; initializing the 
pointer fields to the NULL value, the character string LABEL (if a 
node cell) to four blanks, and numeric fields to zero. The calling 
sequence is as follows: 
DECIARE TYPE FIXED BINARY(15), 
POINT POINTER, 
ALLOC ENTRY(FIXED BIN(15), PTR); 
CALL ALLOC (TYPE, POINT) ; 


If TYPE equals 1, a NODE cell is allocated and initialized. If TYPE 


equals 2, an ARC cell is allocated and initialized. In either case, 
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POINT will identify the cell allocated upon return to the calling 
procedure. 

2. P_ARCS prints on file SYSPRINT all nodes and arcs of a graph 
specified by its calling arguments. Starting and ending simple nodes 
and their respective graphs are also printed for super-arcs in the 
graph. User-defined variables associated with each node and arc are 
also printed at the user's disgression. The calling sequence is as 
follows: 

DECLARE POINT POINTER, 
MESG CHARACTER (n), 
P_ARCS ENTRY (PTR,CHAR(*)) ; 
CALL P_ARCS (POINT ,MESG) ; 
The small letter n represents a user-determined value from one to 120. 
POINT is a pointer identifying the graph header cell of the graph the 
user desires to be printed. MESG is printed preceding the printing of 
the graph. It is printed to help the user distinguish between various 
print-outs. 
To use P ARCS, the user should provide a procedure called 
P USER, which will be called by P_ARCS for each node and each arc of 
the graph pointed to by POINT. See the next chapter "User Routines" 
for a detailed discussion of P_USER. 

3. COPY copies a graph merging in copies of graphs represented by 
Super-nodes. The graph returned will not have any super-nodes or 
Super-arcs. This routine is particularly useful when writing user 
analysis routines. Calling this routine will insure that the analysis 
routine will not have to traverse the interface linkage to access 
simple nodes if it would otherwise be necessary. The calling sequence 


is as follows: 
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DECIARE (PORIG,PCOPY) POINTER, 
COPY ENTRY (POINTER, POINTER) ; 


CALL COPY (PORIG, PCOPY) ; 

PORIG is a pointer identifying the graph header cell of the graph to 
be copies. PCOPY is a pointer identifying the graph header cell of 
the copy generated upon return from COPY. Calling FREEALL will return 
a user graph to available storage. This should be done after analysis 
of a copy is complete. 

4, FREEALL will return a graph to available storage, that is, 
it will no longer exist in core storage. The calling sequence is as 
follows: 


DECIARE POINT POINTER, 
FREEALL ENTRY (POINTER) ; 


CALL FREEALL(POINT) ; 
POINT should be set by the calling routine to point to the graph header 
cell of the graph to be returned to available storage. POINT will be 
returned with a NULL value. 

5. DISPAGE will display on the 2250 a page of alphanumeric infor- 
mation. The page is set up by the user in any of his supplied routines. 
DISPAGE will also allow the on-line entry of 74 characters to be 
returned to the calling routine along with light pen and function key- 
board interrupt information. A call to DISPAGE is made in the follow- 
ing manner: 

DECLARE LINE(52) CHARACTER(74), 
(CODE, POS) FIXED BINARY(31), 
DISPAGE ((52)CHAR(74) , FIXED BIN(31), 
FIXED BIN(31)); 
CALL DISPAGE (LINE ,CODE, POS) ; 
LINE(1) is the top line displayed; LINE(2) is immediately under LINE(1) 


and so forth. 
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CODE is the LINE number (1-52) in which a cursor will be inserted. 

The user may then enter alphanumeric characters from the keyboard. 
The characters entered will replace those that were in the LINE at 
the time of the call to DISPAGE. If CODE is less than one or greater 

than 52, a cursor will not be inserted. 

POS is the index (1-74) of the character in LINE(CODE) under which 
the cursor will be inserted. If POS is less than one or greater than 
74, the cursor will not be inserted. 

DISPAGE will return to the user's procedure upon either of the 
following actions: 

a. A light pen interrupt. Upon positioning the light pen on 
a character displayed, CODE will be set to the LINE on which the light 
pen was positioned. POS will be the inlex (1-74) of the character in 
the LINE detected. 

b. A function key interrupt. Upon pressing a function key, 
CODE will be set to a negative number or zero. The absolute value will 
equal the number of the key pressed. 

This routine provides a straightforward manner for the user to 
communicate on-line with his initialization and analysis routines 


N USER, ANALYZE, and BUTTONS. 
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V. USER ROUTINES 


The following procedures should be supplied by the user prior to 
running the system. Two of them, N_USER and P_USER concern the 
initialization and printing of user-defined cell fields. ANALYZE 
and BUTTONS are called by the system upon an on-line user-generated 
interrupt. 

Four fields are reserved in each NODE cell for the user. One 
field is reserved in each ARC cell. The user fields are declared as 
follows: 

DECIARE 1 NODE BASED (PP), 
2 XCOR FLOAT BINARY(21), 
2 YCOR FLOAT BINARY(21), 

2 ON_OFF BIT(2), 


2 USER POINTER, 


1 ARC BASED (PARC), 


2 USERA POINTER, 


These fields may be initialized by the user routine N_USER and 
referenced by the user's analysis routines BUTTONS and ANALYZE. He 
may design another cell to hold additional information and set the 
pointer fields USER and USERA to address these cells. 

User routines which reference NODE or ARC cells must contain a 
declaration of NODE or ARC as it appears in the program listing. If 
not, a compiler =rror message will be issued and the system will not 


execute. The four user routines are described below in detail. 
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A. N_USER 

This routine is called by the system each time a node or arc is 
added to or removed from a graph through the Graph Manipulation Frame. 
The system calls N_USER in the following manner: 

DECLARE POINT POINTER, 
IX FIXED BINARY(15), 
N_USER ENTRY (POINTER,FIXED BIN(15)) ; 
CALL N_USER(POINT, IX) ; 
POINT will identify either a NODE cell or an ARC cell depending on 
the value of IX. 

If IX equals one, the NODE cell identified by POINT will be added 
to the graph. Upon return from N_USER, the Peer viii display the 
octagon around the corresponding node on the screen. 

If IX equals two, the NODE cell identified by POINT will be deleted 
from the graph upon return from N_USER. 

If IX equals three, the ARC cell identified by POINT will be added 
to the graph. Upon return from N_USER, the system will display the 
arrow representing the arc. 

If IX equals four, the ARC cell identified by POINT will be deleted 
from the graph upon return from N_USER. 

This routine is called before the deletion of a cell so that storage 
dynamically allocated for user-defined cells peepei ated with the node 


and arc may be freed before the pointers to these cells are lost. 


B. P USER 
This routine is called by the system routine P_A’°S. It allows 
the user to append text to that printed by P_ARCS for each node and 


arc. It is called by the system in the following manner: 
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DECLARE (ND,AR) POINTER, 
MESG CHARACTER (120), 
POUSHRVENIRY (PERS PIR ,GHAR(1Z0) ); 
CALL P_USER(ND,AR,MESG) ; 
For each node that will be printed by P_ARCS, a call to P_USER with ND 
identifying the NODE cell will be made. AR will be set to NULL. The 
user may fill the character string MESG which will be printed with the 
node upon return to P_ARCS. 
Likewise, for each arc to be printed, another call to P USER will 


be made. ND will be NULL and AR will identify the corresponding ARC 


cell. Again, the MESG returned will be printed with the arc. 


C, BUTTONS 

This routine is called by the system when the user presses a 
function key while the Graph Manipulation Frame is in the ready state. 
The call is made in the following manner: 


DECLARE NO FIXED BINARY(15), 
BUTTONS ENTRY(FIXED BIN(15)); 


CALL BUTTONS (NO) ; 
The variable NO will be set to the number of the function key pressed, 
zero through 31. By declaring the based structures and system external 
variables, the user has access to the graphs in the system. After 
analyzing a graph, the user may call system routine DISPAGE to display 
a page of alphanumeric information concerning the analysis and, at the 
same time, retrieve light pen and function key information from the 


2250 on-line. 


D. ANALYZE 
This routine is called if the light pen is positioned on the ANALYZE 


option of the Graph Manipulation Frame when it is in the ready state. 
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The system performs the call with the statement: CALL ANALYZE. 
There are no calling arguments; however, by declaring the based 
structures and system external variables, the user has access to the 
graphs in the system. After analyzing a graph, the user may call 
system routine DISPAGE to display a page of information concerning 
the analysis and, at the same time, retrieve light pen and function 
keyboard information from the 2250 on-line. 

Upon returning from ANALYZE or BUTTONS, the system will return to 
the Graph Manipulation Frame with the graph displayed immediately prior 


to the invoking of the user routine. 
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VI. CARD IMAGE FORMAT 


A card image format is used with which graphs may be input to the 
system instead of using the Graph Manipulation Frame to completely 
specify a graph. Also, the system generates a card image file when 
the SAVE option is selected with the same card formats. 

Four type of cards are described below. Brackets indicate that 
information between them is optional. Lower case letters must be 
replaced by entities they represent. The card format is free form in 
card columns one to 72. If the data shown below for a particular 
card will not fit on a single card, it may be continued on the next 
as if the card were 144 columns wide. The only places where spaces 
are not allowed are the following: 

1) Between the characters of a node name 

2) Between the characters of a graph name 
3) Between the characters of the word GRAPH 
4) Between the characters of the word END 

The cards are organized in groups called data packets. Each 
packet defines a graph. The first card of a packet is the GRAPH 
card. It contains the name of the graph. Next node and arcs are 
specified by the NODE and ARC cards. Finally, an END card signifies 
the end of the packet. A packet may be used to augment a graph 
already in the system. Several NODE and ARC cards may appear in a 
packet. A packet may be used to augment a graph already in the 
system. Several NODE and ARC -ards may appear in a packet inter- 


Spersed. Super-nodes and super-arcs may be input along with user- 


defined values to be associated with the nodes and arcs. 
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A. GRAPH CARD 

The GRAPH card starts a data packet and contains the name of the 
graph to be initialized or augmented. 

GRAPH (gname ) 

"ename" is a user-defined, four-character graph name. If not 

specified, a default name, SSnn, will be substituted where nn 

is a decimal integer. 
B. NODE CARD 

The NODE card specifies the nodes to ‘Se added to the graph 
associated with the packet by the previous GRAPH card. 


N(node specification [,node specification, 
ynode specification]) 


"node specification" is defined as 
n-name[ (gname)][$ user-mes $] 


"n-nam:'' is a user-defined, four-character node name (of which 
the first two characters are alphabetic). 


"oname'' is the graph represented by n-name if the node is a 
super-node. "gname" must be a graph submitted by an earlier 
data packet or by the user through the Graph Manipulation Frame. 
"user-mes" is a maximum of forty characters passed to N_USER 
in the external variable MES, The dollar signs are truncated 
from user-mes before the call to N USER. If a user-mes does not 
appear with a node, N_USER is not called. 

C. ARC CARD 
The ARC card specifies the arcs for the graph associated with the 


data packet. 


A(are specification [,arc specification, 
arc specification] ) 


"arc specification" is defined as 


V-seq[$ user-mes $]} 
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'V-seq' is the sequence of characters V defined in the paper. 
The first node named in both the starting and ending portions 

of the sequence are restricted to be nodes in the graph of the 
packet. All nodes in the sequence must be previously specified. 
The last node in both portions of the sequence must be a simple 
node. 


"user-mes" is handled the same as user-mes for a node except 
that the N_USER parameter is set to three indicating that an 
arc is to be added. 

END CARD 


This card ends a data packet. 


END 


COMMENTS 


Many packets (graphs) may be submitted at once. The graphs may be 


altered and analyzed through the Graph Manipulation Frame as if they 


were input through the 2250. 
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IBM 2250 Display Unit was written in PL/I (F). Under the IBM System/360 
Operating System, it executed in less than 200K bytes and provided reason- 
able response to on-line interaction. 
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